
APPLICATION NOTE AN-00200 

SDM-USB-QS-S Programmer's Guide 



Uiii 




Introduction 

The SDM-USB-QS drivers allow application software to interface with the module using calls to a DLL. 
The drivers take care of all of the USB protocol and timing freeing the user from the complicated 
firmware development. The architecture of the drivers consists of a Windows WDM driver that com- 
municates with the device via the Windows USB Stack and a DLL that interfaces the Application 
Software (written in C, VC++, C++ Builder, Delphi, Visual Basic etc.) to the WDM driver. This guide 
documents the interface functions and gives examples of how to use them in the application software. 

There are two groups of functions. First are the standard interface functions. The standard interface 
provides a simple, easy to use, set of functions to access the USB module. Second is the EEPROM 
interface, which allows the application software to read and program the various fields in the on-board 
EEPROM, including a user defined area that can be used for application specific purposes. 

The examples of the calls will be shown in Visual Basic and C with Appendix A showing the headers 
and definitions for Visual Basic and Appendix B showing the same for C. 

Standard Interface Functions 

The standard interface functions are a series of calls made to a Dynamic Link Library (dll) that allow 
an application to access the module. These functions are easier to use than WIN32 API calls and offer 
access to features in the module for which there are no API calls. 

A typical system would start with the FT_LISTDEVICES call. This call returns information about all of 
the modules currently connected to the bus. This allows the application software to choose which 
module to communicate with. Before the module can be accessed it must be opened with FT_OPEN 
or FT_OPENEX. These functions return a numeric handle that the rest of the functions use to identi- 
fy the individual modules. Once opened, the device communications settings can be controlled. These 
include functions to set the baud rate (FT_SetBaudRate), set the data characteristics, such as word 
length, stop bits and parity (FT_SetDataCharacteristics), set hardware or software handshaking 
(FT_SetFlowControl), set modem control signals (FT_SetDTR, FT_ClrDTR, FT_SetRTS, FT_ClrRTS), 
get modem status (FT_GetModemStatus), set special characters such as event and error characters 
(FT_SetChars), and set receive and transmit timeouts (FT_SetTimeouts). Additional functions are 
available to reset the device (FT_ResetDevice), purge receive and transmit buffers (FT_Purge), get 
the receive queue status (FT_GetQueueStatus), get the device status (FT_GetStatus), set and reset 
the break condition (FT_SetBreakOn, FT_SetBreakOff), and set conditions for event notification 
(FT_SetEventNotification). I/O is performed using FT_Read and FT_Write. Once communications are 
completed, the device is closed using FT_Close. 

The rest of this section will discuss these functions in detail. 
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FT_ListDevices (Arg1, Arg2, Flags) 

This function can be used to return several kinds of information. First, it can be used to return the 
number of devices currently connected to the bus by setting Flags to LIST_NUMBER_ONLY. In this 
case Arg1 holds the number of devices connected to the bus and Arg2 is null. The function returns 
OK if successful or an error code if there is a problem. 



Visual Basic 






Parameter 


Type 


Description 


Arg1 


long 


Holds the number of devices connected to the bus 


Arg2 


vbNullString 


Null String 


Flags 


long 


Constant. See the appendices for the definitions 


C 

Parameter 


Type 


Description 


Arg1 


pvoid 


A pointer to a dword that holds the number 


Arg2 


Null 


Null 


Flags 


dword 


Constant. See the appendices for the definitions 



This function can also be used to return the device description or serial number by setting Flags to 
LIST_BY_INDEX OFtd with either OPEN_BY_DESCRIPTION or OPEN_BY_SERIAL_NUMBER 
respectively. In this case Arg1 is an integer to hold the index of the device and Arg2 is a string to 
hold the returned information. Indexes are zero-based and the error code DEVICE_NOT_FOUND is 
returned for an invalid index. 

Visual Basic 



Parameter Type Description 

Arg1 integer Holds the index number of the desired device 

Arg2 string String that holds the serial number or description 

Flags long Constant. See the appendices for the definitions 

C 

Parameter Type Description 

Arg1 dword Holds the index number of the desired device 

Arg2 char A pointer to a buffer to contain the appropriate string 

Flags dword Constant. See the appendices for the definitions 



Examples 

The following Visual Basic code demonstrates how to get the number of devices connected to the 
bus. 

Dim IngStatus As Long 

Dim IngNumDevices As Long 

IngStatus = FT_GetNumDevices (IngNumDevices, vbNullString, LIST_NUMBER_ONL Y) 
If IngStatus = OK Then 

'The function was successful, the number of devices connected is in IngNumDevices 

Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 

End If 
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This example shows how to get the description and serial number of the first device on the bus. 

Dim intlndex As Integer 

Dim strDescription As String * 256 

Dim strSerialNumber As String * 256 

intlndex = 

' Get the device description 

IngStatus = FT_ListDevices (intlndex, strDescription, LIST_BYJNDEX Or OPEN_BY_DESCRIPTION) 
IflngStatus = OK Then 

'The function was successful, the description is in strDescription 

Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 

End If 

' Get the device serial number 

IngStatus = FT_ListDevices (intlndex, strSerialNumber, LIST_BY_INDEX Or OPEN_BY_SERIAL_NUMBER) 
If IngStatus = OK Then 

'The function was successful, the serial number is in strSerialNumber 

Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 

End If 

Note that incrementing index will access the next device on the bus. If multiple devices will be con- 
nected, ListDevices can first be used to return the number of devices, then this number used to set 
the exit condition of a loop. The loop can increment the index and return the information for each 
device in turn. Following is the C code to perform the same routines as above. 

ULONG Status; 
DWORD NumDevices; 

Status = FT_ListDevices (&numDevs, NULL, LIST_NUMBER_ONLY); 
if (Status == OK) { 

// The function was successful, the number of devices connected is in NumDevices 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 



DWORD devlndex = 0; 
char Description[256]; 
char SerialNumber[256]; 

Status = FT_ListDevices ((PVOID)devlndex, Description, LIST_BY_INDEX I OPEN_BY_DESCRIPTION); 
if (Status == OK) { 

// The function was successful, the description is in Description 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 

Status = FT_ListDevices ((PVOID)devlndex, SerialNumber, LIST_BY_INDEX I OPEN_BY_SERIAL_NUMBER); 
if (Status == OK) { 

// The function was successful, the serial number is in SerialNumber 

} 

gIsg { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 



AN-00200 

Linx SDM-USB-QS Programmer's Guide 



Page 5 



FT_Open (Device, Handle) 

This function opens a device and returns a numeric handle that is used by the other functions to 
identify the device. Device is the index number of the device to be opened and Handle is a number 
that the function returns to uniquely identify the device so that other functions can access it. Since 
the index number of the device is used to open it so there is no ability to open a specific named 
device, but FT_OPEN_EX can open a device using the description or serial number. If the function 
executes successfully then it will return OK otherwise it will return an error code. 



Visual Basic 
Parameter 

Device 
Handle 

C 

Parameter 

Device 
Handle 



Type Description 

integer Index number of the device to be opened 

long A number that uniquely identifies the device 

Type Description 

integer Index number of the device to be opened 

pvoid A pointer to a number that uniquely identifies the device 



Examples 

The following Visual Basic code demonstrates this function. 



Dim IngHandle As Long 
Dim IngStatus As Long 

IngStatus = FT_Open (0, IngHandle); 
If IngStatus = OK Then 

'The function was successful, the handle of device is in IngHandle 

Else 



End If 



'The function failed. The error code can be reviewed and appropriate corrective action taken 



The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 

Status m FTJDpen (0, AHandle); 
if (Status == OK) { 

// The function was successful, the handle of device is in Handle 

} 



{ 



// The function failed. The error code can be reviewed and appropriate corrective action taken 
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FT_OpenEx (Arg1, Flags, Handle) 

This function will open a specific device using either a serial number or description and return a 
numeric handle that is used by other functions to access the device. Arg1 will be a string that con- 
tains either the serial number or description of the device to be opened. Flags is either 
OPEN_BY_SERIAL_NUMBER or OPEN_BY_DESCRIPTION and determines whether the serial 
number or description is used. Handle is a number that the function returns to uniquely identify the 
device so that other functions can access it. If the function executes successfully then it will return 
OK otherwise it will return an error code. 



Visual Basic 

Parameter 

Arg1 

Flags 

Handle 

C 

Parameter 

Arg1 

Flags 

Handle 



Type Description 

string String of the description or serial number 

integer Constant. See the appendices for the definitions 

long A number that uniquely identifies the device 

Type Description 

pvoid A pointer to a null terminated string 

integer Constant. See the appendices for the definitions 

pvoid A pointer to a number that uniquely identifies the device 



Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 

Dim IngStatus As Long 

Dim strSerialNumber As String * 256 

IngStatus = FT_OpenEx (strSerialNumber, OPEN_BY_SERIAL__NUMBER, IngHandle) 
If IngStatus = OK Then 

'The function was successful, the device's handle is in IngHandle 

Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 

End If 

The following C code demonstrates this function. 



PVOID Handle; 
ULONG Status; 



Status = FT_OpenEx ("LT000001", OPEN_B Y__SERIAL_NUMBER, &Handle); 
if (Status == OK) { 

// The function was successful, the device with serial number LT000001 is open and the handle is in Handle 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 
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FT_Close (Handle) 

This function closes communication with an open device identified by Handle. If the function exe- 
cutes successfully then it will return OK otherwise it will return an error code. 



Visual Basic 
Parameter 

Handle 

C 

Parameter 

Handle 



Type Description 

long A number that uniquely identifies the device 

Type Description 

pvoid A pointer to a number that uniquely identifies the device 



Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 

IngStatus = FT_Close (IngHandle) 
If IngStatus = OK Then 

'The function was successful, the device is closed 

Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 

End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 

Status = FT_Close (AHandle); 
if (Status == OK) { 

// The function was successful, the device is closed 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 
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FT_Read (Handle, Buffer, BytesToRead, BytesReturned) 

This function reads the data available from the device. Handle is a number returned by FT_Open or 
FT_OpenEx, Buffer is a string or character array that receives the data read from the device, 
BytesToRead is the number of bytes the function should read, and BytesReturned is the actual num- 
ber of bytes that were read. If the function executes successfully then it will return OK otherwise it 
will return an error code. 

This function does not return until BytesToRead bytes have been read into the buffer. This can 
cause an application to hang while waiting for the function to return. There are two ways to avoid 
this. The first is to get the number of bytes in the device's receive queue by calling FT_GetStatus or 
FT_GetQueueStatus, and passing this to FT_Read as BytesToRead so that the function reads the 
device and returns immediately. 

The second way is by specifying a timeout in a previous call to FT_SetTimeouts. FT_Read returns 
when the timer expires or when BytesToRead bytes have been read, whichever occurs first. If the 
timeout occurred, FT_Read reads the available data into the buffer and returns OK. 

An application should use the function return value and BytesReturned to check the buffer. If the 
return value is OK and BytesReturned is equal to BytesToRead then FT_Read has completed suc- 
cessfully. If the return value is OK and BytesReturned is less than BytesToRead then a timeout has 
occurred and the read has been only partially completed. Note that if a timeout occurred and no 
data was read, the return value is still OK. 



Visual Basic 
Parameter 

Handle 
Buffer 

BytesToRead 
BytesReturned 

C 

Parameter 

Handle 
Buffer 

BytesToRead 



Type 

long 
string 
long 
long 

Type 

pvoid 
Ipvoid 
dword 
Ipdword 



Description 

A number that uniquely identifies the device 
String to hold the data read from the device 
The number of bytes to read from the device 
The number of bytes that were read from the device 



Description 

A pointer to a number that uniquely identifies the device 

A pointer to a char array to hold the data read from the device 

The number of bytes to read from the device 

A pointer to a dword that gets the number of bytes read 



Examples 

The following Visual Basic code demonstrates this function. FT_GetStatus is called and the number 
of bytes available in the device is checked. If it is greater than zero, then FT_Read is called to get 
the data. 

Dim IngHandle As Long 

Dim IngStatus As Long 

Dim IngBytesRead As Long 

Dim strReadBuffer As String * 256 

Dim IngRXBytes As Long 

Dim IngTXBytes As Long 

Dim IngEvents As Long 
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If FT_GetStatus (IngHandle, IngRXBytes, IngTXBytes, IngEvents) = OK Then 
If IngRXBytes > Then 

IngStatus = FTJRead (IngHandle, strReadBuffer, IngRXBytes, IngBytesRead) 
If (IngStatus = OK) Then 

'The function was successful, the data is in strReadBuffer and IngBytesRead has the number of bytes read 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

End If 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 
DWORD Event; 
DWORD RxBytes; 
DWORD TxBytes; 
DWORD BytesReceived; 
char RxBuffer[256]; 

FT_GetStatus (ftHandle, &RxBytes, &TxBytes, &Event); 
if (RxBytes > 0) { 

Status = FT_Read (Handle, RxBuffer, RxBytes, &BytesReceived); 

if (Status == OK) { 

// The function was successful, the data is in RxBuffer and BytesReceived has the number of bytes read 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 

} 
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FT_Write (Handle, Buffer, BytesToWrite, BytesWritten) 

This function writes BytesToWrite bytes of Buffer to the device described by Handle and returns 
BytesWritten as the number of bytes that it actually wrote. If the function executes successfully then 
it will return OK otherwise it will return an error code. 



10I nolo 

visual Basic 






Parameter 


Type 


Description 


Handle 


long 


A number that uniquely identifies the device 


Buffer 


string 


String to hold the data to be written to the device 


BytesToWrite 


long 


The number of bytes to write to the device 


BytesWritten 


long 


The number of bytes that were written to the device 


C 

Parameter 


Type 


Description 


Handle 


pvoid 


A pointer to a number that uniquely identifies the device 


Buffer 


Ipvoid 


A pointer to a char array to hold the data read from the device 


BytesToWrite 


dword 


The number of bytes to read from the device 


BytesWritten 


Ipdword 


A pointer to a dword that gets the number of bytes read 


Examples 






The following Visual Basic code demonstrates this function. 



Dim IngHandle As Long 
Dim IngStatus As Long 
Dim strWriteBuffer As String 
Dim IngBytesWritten As Long 
Dim /ngBytesToWrite As Long 

/naBytesToWrite = 1 'Sets the number of bytes to write to 1 

IngStatus = FT_Write (IngHandle, strWriteBuffer, /ngBytesToWrite, IngBytesWritten) 
If IngStatus <> OK Then 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 
DWORD BytesToWrite; 
DWORD BytesWritten; 
char WriteBuffer[256]; 
char *Buff; 



Buff= WriteBuffer; 
BytesToWrite = 1; 



// Sets the number of bytes to write to 1 



Status = FT_Write (Handle, Buff, BytesToWrite, ABytesWritten); 
if (Status != OK) { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 
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FT_SetBaudRate (Handle, BaudRate) 

This function sets the baud rate of the device described by Handle to BaudRate. If the function exe- 
cutes successfully then it will return OK otherwise it will return an error code. 



Visual Basic 
Parameter 

Handle 
BaudRate 

C 

Parameter 

Handle 
BaudRate 



Type Description 

long A number that uniquely identifies the device 

single The baud rate in bits per second 

Type Description 

pvoid A pointer to a number that uniquely identifies the device 

dword The baud rate in bits per second 



Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 
Dim sngBaudRate As Single 



sngBaudRate = 9600 '9600bps baud 

IngStatus = FT_SetBaudRate (IngHandle, sngBaudRate) 
If IngStatus = OK Then 

'The function was successful, the baud rate is set to sngBaudRate 



'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 



PVOID Handle; 
ULONG Status; 
DWORD BaudRate; 



BaudRate = 9600; 

Status = FT_SetBaudRate (Handle, BaudRate); 
if (Status == OK) { 

// The function was successful, the baud rate is set to BaudRate 

} 

{ 

// The function failed. The error code can be reviewed and appropriate corrective action taken 
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FT_SetDataCharacteristics (Handle, WordLength, StopBits, Parity) 

This function sets the data characteristics for the device described by Handle. It will set the stream 
to have WordLength number of bits in each word, StopBits number of stop bits, and Parity parity. 
WordLength must be either BITS_8 or BITS_7. StopBits must be either STOP_BITS_1 or 
STOP_BITS_2. Parity can be PARITYJMONE, PARITY_ODD, PARITY_EVEN, PARITY_MARK, or 
PARITY_SPACE. All of these variables are defined in the header files in the appendices. If the func- 
tion executes successfully then it will return OK otherwise it will return an error code. 



Visual Basic 
Parameter 

Handle 
WordLength 
StopBits 
Parity 

C 

Parameter 

Handle 
WordLength 
StopBits 
Parity 



Type Description 

long A number that uniquely identifies the device 

integer A number representing the number of bits in each word 

integer A number representing the number of stop bits in each word 

integer A number representing the type of parity used in each word 

Type Description 

pvoid A pointer to a number that uniquely identifies the device 

uchar A number representing the number of bits in each word 

uchar A number representing the number of stop bits in each word 

uchar A number representing the type of parity used in each word 



Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 

Dim IngStatus As Long 

Dim intStops As Integer = STOP_BITS_ 1 

Dim intParity As Integer = PARITY_NONE 

Dim intDataBits As Integer = BITS_8 

IngStatus = FT_SetDataCharacteristics (IngHandle, intDataBits, intStops, intParity) 
If IngStatus = OK Then 

'The function was successful, the data is set to intDataBits data bits, intStops stop bits, and intParity parity 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 

UCHAR WordLength = BITS_8; 
UCHAR StopBits = STOP_BITS_ 1; 
UCHAR Parity = PARITY_NONE; 

Status = FT_SetDataCharacteristics (Handle, WordLength, StopBits, Parity); 
if (Status == OK) { 

// The function was successful, the data is set to WordLength data bits, StopBits stop bits, and Parity parity 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 
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FT_SetFlowControl (Handle, FlowControl, Xon, Xoff) 

This function will set the flow control for the device described by Handle. FlowControl must be 
FLOW_NONE, FLOW_RTS_CTS, FLOW_DTR_DSR, or FLOW_XON_XOFF. All of these variables 
are defined in the header files in the appendices. Xon is the character used to signal XON, and Xoff 
is the character used to signal XOFF. These are only used if FlowControl is set to 
FLOW_XON_XOFF, otherwise they are set to zero or null. If the function executes successfully then 
it will return OK otherwise it will return an error code. 

Visual Basic 



Parameter Type Description 

Handle long A number that uniquely identifies the device 

FlowControl single A number representing the type of flow control 

Xon string A character that signals XON 

Xoff string A character that signals XOFF 

C 

Parameter Type Description 

Handle pvoid A pointer to a number that uniquely identifies the device 

FlowControl ushort A number representing the type of flow control 

Xon uchar A character that signals XON 

Xoff uchar A character that signals XOFF 



Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 

IngStatus = FT_SetFlowControl (IngHandle, FLOW_NONE, 0, 0) 
If IngStatus = OK Then 

'The function was successful, the flow control is set to FlowControl and the XON and XOFF characters are set 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 

USHORT FlowControl = FT_FLOW_NONE; 
UCHAR XonChar = 0; 
UCHAR XoffChar = 0; 

Status = FT_SetFlowControl (Handle, FlowControl, XonChar, XoffChar); 
if (Status == OK) { 

// The function was successful, the flow control is set to FlowControl and the XON and XOFF characters are set 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 
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FT_SetDTR (Handle) 

This function sets the Data Terminal Ready control line. This can be used for handshaking when the 
flow control is set to FLOW_DTR_DSR, or it can be used to control external circuitry. If the function 
executes successfully then it will return OK otherwise it will return an error code. 



Visual Basic 
Parameter 

Handle 

C 

Parameter 

Handle 



Type 

long 

Type 

pvoid 



A number that uniquely identifies the device 
Description 

A pointer to a number that uniquely identifies the device 



Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 

IngStatus = FT_SetDTR (IngHandle) 
If IngStatus = OK Then 

'The function was successful, the DTR line is set 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 

Status = FT_SetDTR (Handle); 
if (Status == OK) { 

// The function was successful, the DTR line is set 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 
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FT_ClrDTR (Handle) 

This function clears the Data Terminal Ready control line. This can be used for handshaking when 
the flow control is set to FLOW_DTR_DSR, or it can be used to control external circuitry. If the funo 
tion executes successfully then it will return OK otherwise it will return an error code. 



Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 

IngStatus = FT_ClrDTR (IngHandle) 
If IngStatus = OK Then 

'The function was successful, the DTR line is cleared 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 

Status = FT_ClrDTR (Handle); 
if (Status == OK) { 

// The function was successful, the DTR line is cleared 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 



Visual Basic 
Parameter 

Handle 



Type 

long 



Description 

A number that uniquely identifies the device 



C 

Parameter 

Handle 



Type 

pvoid 



Description 

A pointer to a number that uniquely identifies the device 
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FT_SetRTS (Handle) 

This function sets the Request To Send control line. This can be used for handshaking when the 
flow control is set to FLOW_RTS_CTS, or it can be used to control external circuitry. If the function 
executes successfully then it will return OK otherwise it will return an error code. 



Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 

IngStatus = FT_SetRTS (IngHandle) 
If IngStatus = OK Then 

'The function was successful, the RTS line is set 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 

Status = FT_SetRTS (Handle); 
if (Status == OK) { 

// The function was successful, the RTS line is set 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 



Visual Basic 
Parameter 

Handle 



Type 

long 



Description 

A number that uniquely identifies the device 



C 

Parameter 

Handle 



Type 

pvoid 



Description 

A pointer to a number that uniquely identifies the device 
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FT_ClrRTS (Handle) 

This function clears the Request To Send control line. This can be used for handshaking when the 
flow control is set to FLOW_RTS_CTS, or it can be used to control external circuitry. If the function 
executes successfully then it will return OK otherwise it will return an error code. 



Visual Basic 
Parameter 

Handle 

C 

Parameter 

Handle 



Type Description 

long A number that uniquely identifies the device 

Type Description 

pvoid A pointer to a number that uniquely identifies the device 



Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 

IngStatus = FT_ClrRTS (IngHandle) 
If IngStatus = OK Then 

'The function was successful, the RTS line is cleared 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 

Status = FT_ClrRTS (Handle); 
if (Status == OK) { 

// The function was successful, the RTS line is cleared 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 
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FT_GetModemStatus (Handle, ModemStatus) 

This function is used to determine the state of the input control lines, CTS, DSR, Rl, and CDC. If the 
function executes successfully then it will return OK otherwise it will return an error code. 

Visual Basic 
Parameter 

Handle 
ModemStatus 



C 

Parameter 

Handle 
ModemStatus 



Type 

long 
long 

Type 

pvoid 
Ipdword 



Description 

A number that uniquely identifies the device 
A variable that receives a number representing the modem status 

Description 

A pointer to a number that uniquely identifies the device 

A pointer to a dword variable that receives the modem status 



Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 

Dim IngStatus As Long 

Dim IngModemStatus As Long 

IngStatus = FT_GetModemStatus (IngHandle, IngModemStatus) 

If (IngModemStatus And MODEM_STATUS_CTS) = MODEM_STATUS_CTS Then 

'CTS is high 
Else 

'CTS is low 
End If 

If (IngModemStatus And MODEM_STATUS_DSR) = MODEM_STATUS_DSR Then 

'DSR is high 
Else 

'DSR is low 
End If 

If (IngModemStatus And MODEM_STA TUS_DCD) = MODEM_STATUS_DCD Then 

'DCD is high 
Else 

'DCD is low 
End If 

If (IngModemStatus And MODEM_STA TUS_RI) = MODEM_STATUS_RI Then 

'Rl is high 
Else 

'Rl is low 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 
DWORD ModemStatus; 

Status = FT_GetModemStatus (Handle, &ModemStatus); 
if ((ModemStatus & MODEM_STATUS_CTS) == MODEM_STATUS_CTS) { 
//CTS is high 

} 

else { 

// CTS is low 
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) 

if ((ModemStatus & MODEM_STA TUS_DSR) == MODEM_STATUS_DSR) { 
//DSRishigh 

} 

else { 

//DSRislow 

} 

if ((ModemStatus & MODEM_STATUS_DCD) == MODEM_STA TUS_DCD) { 
//DCDishigh 

} 

else { 

//DCDislow 

} 

if ((ModemStatus & MODEM_STATUS_RI) == MODEM_STATUS_RI) { 
//Rl is high 

} 

else { 

//Rlislow 

} 
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FT_SetChars (Handle, EventCh, EventChEn, ErrorCh, ErrorChEn ) 



This function sets the special characters for the device. If the function executes successfully then it 
will return OK otherwise it will return an error code. 



Visual Basic 
Parameter 

Handle 

EventCh 

EventChEn 

ErrorCh 

ErrorChEn 

C 

Parameter 

Handle 

EventCh 

EventChEn 

ErrorCh 

ErrorChEn 



Type Description 

long A number that uniquely identifies the device 

string Event character 

string if the event character is disabled, non-zero otherwise 

string Error character 

string if the error character is disabled, non-zero otherwise 

Type Description 

pvoid A pointer to a number that uniquely identifies the device 

uchar Event character 

uchar if the event character is disabled, non-zero otherwise 

uchar Error character 

uchar if the error character is disabled, non-zero otherwise 



Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 
Dim strEventCh As String 
Dim strEventChEn As String 
Dim strErrorCh As String 
Dim strErrorChEn As String 

IngStatus = FT_SetChars (IngHandle, strEventCh, StrEventChEn, strErrorCh, strErrorChEn) 
If IngStatus = OK Then 

'The function was successful, the FITS line is cleared 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 
UCHAR EventCh; 
UCHAR EventChEn; 
UCHAR ErrorCh; 
UCHAR ErrorChEn; 

Status = FT_SetChars (Handle, EventCh, EventChEn, ErrorCh, ErrorChEn); 
if (Status == OK) { 

// The function was successful, 

} 

else { 



} 



// The function failed. The error code can be 



corrective action taken 
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FT_Purge (ftHandle, Mask) 



This function purges receive and transmit buffers in the device. If the function executes successfully 
then it will return OK otherwise it will return an error code. 



Visual Basic 
Parameter 

Handle 
Mask 

C 

Parameter 

Handle 
Mask 



Type Description 

long A number that uniquely identifies the device 

long Any combination of PURGE_RX and PURGE_TX 

Type Description 

pvoid A pointer to a number that uniquely identifies the device 

dword Any combination of PURGE_RX and PURGE_TX 



Examples 

The following Visual Basic code demonstrates this function 

Dim IngHandle As Long 
Dim IngStatus As Long 
Dim IngMask As Long 



rs have been cleared 



IngMask = PURGE_RX Or PURGE_TX 

IngStatus = FT_Purge (IngHandle, IngMask) 
If IngStatus = OK Then 

'The function was successful, the receive and t 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 
DWORD Mask; 

Mask = PURGE_RX I PURGE_TX; 

Status = FT_Purge (Handle, Mask); 
if (Status == OK) { 

// The function was successful, the receive and transmit buffers have been cleared 

} 

{ 

// The function failed. The error code can be reviewed and appropriate corrective action taken 
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FT_SetTimeouts (Handle, ReadTimeout, WriteTimeout) 

This function sets the read and write timeouts for the device. If the function executes successfully 
then it will return OK otherwise it will return an error code. 



Visual Basic 
Parameter 

Handle 

ReadTimeout 

WriteTimeout 

C 

Parameter 

Handle 

ReadTimeout 

WriteTimeout 



Type Description 

long A number that uniquely identifies the device 

long Read timeout in milliseconds 

long Write timeout in milliseconds 

Type Description 

pvoid A pointer to a number that uniquely identifies the device 

dword Read timeout in milliseconds 

dword Write timeout in milliseconds 



Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 

IngStatus = FT_SetTimeouts (IngHandle, 5000, 1000) 
If IngStatus = OK Then 

'The function was successful, the read timeout is set to 5 seconds and the write timeout is set to 1 second 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 



The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 



Status = FT_SetTimeouts (Handle, 5000, 1000); 
if (Status == OK) { 

// The function was successful, the read timeout is set to 5 seconds and the write timeout is set to 1 second 

} 

else { 



} 



// The function failed. The error code can be reviewed and appropriate corrective action taken 
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FT_GetQueueStatus (Handle, AmountlnRxQueue ) 

This function gets the number of characters currently in the receive queue and places the value in 
AmountlnRxQueue. This function can be called and the value in AmountlnRxQueue can be passed 
to FT_Read as BytesToRead so that the Read function will read the receive buffer and return imme- 
diately. If the function executes successfully then it will return OK otherwise it will return an error 
code. 

Visual Basic 

Parameter Type Description 

Handle long A number that uniquely identifies the device 

AmountlnRxQueue long Receives the number of characters in the receive queue 

C 

Parameter Type Description 

Handle pvoid A pointer to a number that uniquely identifies the device 

AmountlnRxQueue Ipdword A pointer to a dword that gets the number of characters available 

Examples 

The following Visual Basic code demonstrates this function. 



Dim IngHandle As Long 

Dim IngStatus As Long 

Dim IngAnountlnRxQueue as Long 

IngStatus = FT_GetQueueStatus (IngHandle, IngAnountlnRxQueue) 
If IngStatus = OK Then 

'The function was successful, the number of characters in the receive queue is in IngAnountlnRxQueue 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 
DWORD AnountlnRxQueue; 

Status = FT_GetQueueStatus (Handle, &AnountlnRxQueue); 
if (Status == OK) { 

// The function was successful, the number of characters in the receive queue is in AnountlnRxQueue 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

I 
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FT_SetBreakOn (Handle) 

This function sets the break condition for the device. If the function executes successfully then it will 
return OK otherwise it will return an error code. 



Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 

IngStatus = FT_SetBreakOn (IngHandle) 
If IngStatus = OK Then 

'The function was successful, the break condition is set 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 

Status = FT_SetBreakOn (Handle); 
if (Status == OK) { 

// The function was successful, the break condition is set 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 



Visual Basic 
Parameter 

Handle 



Type 

long 




Description 



C 

Parameter 

Handle 



Type 

pvoid 



Description 

A pointer to a number that uniquely identifies the device 
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FT_SetBreakOff (Handle) 

This function resets the break condition for the device. If the function executes successfully then it 
will return OK otherwise it will return an error code. 



Visual Basic 
Parameter 

Handle 

C 

Parameter 

Handle 



Type Description 

long A number that uniquely identifies the device 

Type Description 

pvoid A pointer to a number that uniquely identifies the device 



Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 

IngStatus = FT_SetBreakOff (IngHandle) 
If IngStatus = OK Then 

'The function was successful, the break condition is reset 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 

Status = FT_SetBreakOff (Handle); 
if (Status == OK) { 

// The function was successful, the break condition is reset 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 
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FT_GetStatus (Handle, AmountlnRxQueue, AmountlnTxQueue, EventStatus) 

This function gets the status of the device. AmountlnRxQueue gets the number of characters in the 
receive queue, AmountlnTxQueue gets the number of characters in the transmit queue, and 
EventStatus gets a combination of EVENT_RXCHAR if a character is received and 
EVENT_MODEM_STATUS if the modem lines change states. If the function executes successfully 
then it will return OK otherwise it will return an error code. 



Visual Basic 






Parameter 


Type 


Description 


Handle 


long 


A number that uniquely identifies the device 


AmountlnRxQueue 


long 


Gets the number of bytes in the receive queue 


AmountlnTxQueue 


long 


Gets the number of bytes in the transmit queue 


EventStatus 


long 


Gets a value of an event or returns zero 



c 

Parameter Type Description 

Handle pvoid A pointer to a number that uniquely identifies the device 

AmountlnRxQueue Ipdword A pointer to a dword that gets the amount in the receive queue 

AmountlnTxQueue Ipdword A pointer to a dword that gets the amount in the transmit queue 

EventStatus Ipdword A pointer to a dword that gets the event status 

Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 

Dim IngStatus As Long 

Dim IngAmountlnRxQueue As Long 

Dim IngAmountlnTxQueue As Long 

Dim IngEventStatus As Long 

IngStatus = FT_GetStatus (IngHandle, IngAmountlnRxQueue, IngAmountlnTxQueue, IngEventStatus) 
If IngStatus = OK Then 

'The function was successful 



'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 
DWORD AmountlnRxQueue; 
DWORD AmountlnTxQueue; 
DWORD EventStatus; 

Status = FT_GetStatus (Handle, &AmountlnRxQueue, &AmountlnTxQueue, & EventStatus); 
if (Status == OK) { 

// The function was successful 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 
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FT_SetEventNotification (Handle, EventMask, Arg) 



This function will set the events that the device should look for. EventMask is any combination of 
EVENT_RXCHAR and EVENT_MODEM_STATUS. EVENT_RXCHAR will cause the event to be set 
when a character has been received, and EVENT_MODEM_STATUS will cause the event to be set 
when the modem lines change. Arg is the handle of an event that has been created by the applica- 
tion. This function can be used by an application to set up conditions that allow a thread to block 
until one of the conditions is met. Typically, an application will create an event, call this function, 
then block on the event. When the conditions are met, the event is set, and the application thread 
unblocked. If the function executes successfully then it will return OK otherwise it will return an error 
code. 



Visual Basic 
Parameter 

Handle 

EventMask 

Arg 

C 

Parameter 

Handle 

EventMask 

Arg 



Type 

long 
long 
long 

Type 

pvoid 

dword 

pvoid 



Description 

A number that uniquely identifies the device 

Bit map describing the conditions that cause the event to be set 

The handle of an event 



Description 

A pointer to a number that uniquely identifies the device 

Bit map describing the conditions that cause the event to be set 

The handle of an event 



Examples 

The following Visual Basic code demonstrates this function. First, an event is created and the func- 
tion is called. 

Const INFINITE As Long = 1000 '&HFFFFFFFF 

Dim IngHandle As Long 

Dim IngStatus As Long 

Dim IngEventMask As Long 

Dim IngEventAs Long 

Dim IngModemStatus As Long 



IngEvent = CreateEvent (0, False, False, "") 

IngEventMask = EVENT_RXCHAR Or EVENT_MODEM_STA TUS 

IngStatus = FT_SetEventNotification (IngHandle, IngEventMask, IngEvent) 

'This will wait for the event to trigger and release the object 
IngStatus = WaitForSingleObject (IngEvent, INFINITE) 

'Call FT_GetModemStatus to determine what caused the event 
IngStatus = FT_GetModemStatus (IngHandle, IngModemStatus) 
If (IngModemStatus And MODEM_STATUS_CTS) = MODEM_STATUS_CTS Then 

'CTS is high 
Else 

'CTS is low 
End If 

If (IngModemStatus And MODEM_STA TUS_DSR) m MODEM_STATUS_DSR Then 
'DSR is high 



'DSR is low 
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End If 

If (IngModemStatus And MODEM_STATUS_DCD) = MODEM_STATUS_DCD Then 

VCD is high 
Else 

VCD is low 
End If 

If (IngModemStatus And MODEM_STA TUS_RI) = MODEM_STATUS_RI Then 

'Rl is high 
Else 

'Rl is low 
End If 

The following C code demonstrates this function. First, an event is created and the function is called. 

#define INFINITE 1000 
PVOID Handle; 
ULONG Status; 
PVOID Event; 
DWORD EventMask; 
DWORD ModemStatus; 

Event = CreateEvent (NULL, false, false, "" ); 
EventMask = EVENT_RXCHAR I EVENT_MODEM_STA TUS; 
Status = FT_SetEventNotification (Handle, EventMask, Event); 

// This will wait for the event to trigger and release the object 
WaitForSingleObject (Event, INFINITE); 

// Call FT_GetModemStatus to determine what caused the event 
Status = FT_GetModemStatus (Handle, &ModemStatus); 
if ((ModemStatus & MODEM_STATUS_CTS) == MODEM_STATUS_CTS) { 
//CTSishigh 

} 

else { 

//CTSis low 

} 

if ((ModemStatus & MODEM_STATUS_DSR) == MODEM_STA TUS_DSR) { 
//DSRishigh 

} 

else { 

//DSR is low 

} 

if ((ModemStatus & MODEM_STATUS_DCD) == MODEMJSTA TUSJDCD) { 
//DCDishigh 

} 

else { 

//DCDislow 

} 

if ((ModemStatus & MODEM_STA TUS_RI) == MODEM_STA TUS_RI) { 
//Rl is high 

} 

else { 

//Rlislow 

} 
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FT_ResetDevice (Handle) 

This function will reset the device described by Handle. If the function executes successfully then it 
will return OK otherwise it will return an error code. 

Visual Basic 

Parameter Type Description 

Handle long A number that uniquely identifies the device 

C 

Parameter Type Description 

Handle pvoid A pointer to a number that uniquely identifies the device 

Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 

IngStatus = FT_ResetDevice (IngHandle) 
If IngStatus = OK Then 

'The function was successful, the device is reset 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 

Status = FT_ResetDevice (Handle); 
if (Status == OK) { 

// The function was successful, the device is reset 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 
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FT_ResetPort (Handle) 

This function will send a reset command to the port in an attempt to recover the port after a failure. 
If the function executes successfully then it will return OK otherwise it will return an error code. 



Visual Basic 
Parameter 

Handle 

C 

Parameter 

Handle 



Type Description 

long A number that uniquely identifies the device 

Type Description 

pvoid A pointer to a number that uniquely identifies the device 



Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 

IngStatus = FT_ResetPort (IngHandle) 
If IngStatus = OK Then 

'The function was successful, the port is reset 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 



The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 

Status = FT_ResetPort (Handle); 
if (Status == OK) { 

// The function was successful, the port is reset 



} 



{ 



// The function failed. The error code can be reviewed and appropriate corrective action taken 
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FT_StoplnTask (Handle) 

This function is used to put the driver's IN task (read) into a wait state. It can be used in situations 
where data is being received continuously so that the device can be purged without more data being 
received. It is used together with FT_RestartlnTask, which sets the IN task running again. If the 
function executes successfully then it will return OK otherwise it will return an error code. 

Visual Basic 

Parameter Type Description 

Handle long A number that uniquely identifies the device 

C 

Parameter Type Description 

Handle pvoid A pointer to a number that uniquely identifies the device 

Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 

Do 

IngStatus = FT_StoplnTask (IngHandle) 
Loop While IngStatus <> OK 

'Do something, for example purge the device 

Do 

IngStatus = FT_RestartlnTask (IngHandle) 
Loop While IngStatus <> OK 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 

do{ 

Status = FT_StoplnTask (Handle); 
} while (Status != OK); 

// Do something, for example purge device 

do{ 

Status = FT_RestartlnTask (Handle); 
} while (Status != OK); 
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FT_RestartlnTask (Handle) 

This function is used to restart the driver's IN task (read) after it has been stopped by a call to 
FT_StoplnTask. If the function executes successfully then it will return OK otherwise it will return an 
error code. 



Visual Basic 
Parameter 

Handle 

C 

Parameter 

Handle 



Type 

long 

Type 

pvoid 



A number that uniquely identifies the device 
Description 

A pointer to a number that uniquely identifies the device 



Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 

Do 

IngStatus = FT_StoplnTask (IngHandle) 
Loop While IngStatus <> OK 

'Do something, tor example purge device 

Do 

IngStatus = FT_RestartlnTask (IngHandle) 
Loop While IngStatus <> OK 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 

do{ 

Status = FT_StoplnTask (Handle); 
} while (Status != OK); 

//Do something, for example purge device 

do { 

Status = FT_RestartlnTask (Handle); 
} while (Status != OK); 
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FT_SetResetPipeRetryCount (Handle, Count) 

This function is used to set the ResetPipeRetryCount. ResetPipeRetryCount controls the maximum 
number of times that the driver tries to reset a pipe on which an error has occurred. 
ResetPipeRequestRetryCount defaults to 50. It may be necessary to increase this value in noisy 
environments where a lot of USB errors occur. If the function executes successfully then it will return 
OK otherwise it will return an error code. 

Visual Basic 



Parameter 


Type 


Description 


Handle 


long 


A number that uniquely identifies the device 


Count 


long 


Contains the maximum number of times to try to reset the pipe 


C 

Parameter 


Type 


Description 


Handle 


pvoid 


A pointer to a number that uniquely identifies the device 


Count 


dword 


Contains the maximum number of times to try to reset the pipe 


Examples 







The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 
Dim IngRetryCount As Long 

IngRetryCount = 100 

IngStatus = FT_SetResetPipeRetryCount (IngHandle, IngRetryCount) 
If IngStatus = OK Then 

'The function was successful, ResetPipeRetryCount is set to 100 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 
DWORD RetryCount; 

RetryCount = 100; 

Status = FT_SetResetPipeRetryCount (Handle, RetryCount); 
if (Status == OK) { 

// The function was successful, ResetPipeRetryCount is set to 100 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 
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EEPROM Interface Functions 

The EEPROM interface functions allow the application to access the on-board EEPROM. This can be 
useful in production to allow the programming of the device description as a part of the final produc- 
tion test. In addition, the application can use the free area to store a small amount of information. 

FT_EE_UASize (Handle, Size) 

This function determines the size of the User Area in the EEPROM and returns the number of bytes 
free in Size. This is the largest amount of data that can be stored in the EEPROM by the application. 
If the function executes successfully then it will return OK otherwise it will return an error code. 

Visual Basic 

Parameter Type Description 

Handle long A number that uniquely identifies the device 

Size long A variable that gets the size of the free area in bytes 

C 

Parameter Type Description 

Handle pvoid A pointer to a number that uniquely identifies the device 

Size Ipdword A pointer to a variable that gets the size of the free area in bytes 

Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 
Dim IngSize As Long 

IngStatus = FT_EE_UASize (IngHandle, IngSize) 
If IngStatus = OK Then 

'The function was successful, Size contains the number of bytes free in the EEPROM 



'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 
DWORD Size; 

Status = FT_EE_UASize (Handle, &Size); 
if (Status == OK) { 

// The function was successful, Size contains the number of bytes free in the EEPROM 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 
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FT_EE_UARead (Handle, Data, DataLen, BytesRead) 

This function will read the data in the User Area on the EEPROM. Data contains the data that was 
read by the function, DataLen is the size of the string or character array that receives the data, and 
BytesRead is the actual number of bytes that were read. If DataLen is less than the size of the UA, 
then only DataLen bytes are read into the buffer. Otherwise, the entire UA is read into the buffer. If 
the function executes successfully then it will return OK otherwise it will return an error code. 

Visual Basic 
Parameter 

Handle 
Data 
DataLen 
BytesRead 



Type 

long 
string 
long 
long 

Type 

pvoid 
puchar 
dword 
Ipdword 



Description 

A number that uniquely identifies the device 
A buffer that holds the data from the User Area 
A variable that holds the number of bytes to be read from the UA 
A variable that holde the actual number of bytes read from the UA 

Description 

A pointer to a number that uniquely identifies the device 
A pointer to a buffer that holds the data from the User Area 
A variable that holds the number of bytes to be read from the UA 
A pointer to a variable that receives teh number of bytes read 



C 

Parameter 

Handle 
Data 
DataLen 
BytesRead 

Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 
Dim strData As String * 64 
Dim IngDataLen As Long 
Dim IngBytesRead As Long 

IngDataLen = 64 

IngStatus = FTJEEJJARead (IngHandle, strData, IngDataLen, IngBytesRead) 
If IngStatus = OK Then 

'The function was successful, strData holds IngBytesRead bytes of data read from the UA on the EEPROM 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 
CHAR Data[64]; 
DWORD DataLen; 
DWORD BytesRead; 

DataLen = 64; 

Status = FT_EE_UARead (Handle, Data, DataLen, ABytesRead); 
if (Status == OK) { 

// The function was successful, Data holds BytesRead bytes of data read from the UA on the EEPROM 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 
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FT_EE_UAWrite (Handle, Data, DataLen) 

This function will write the information contained in Data to the User Area in the EEPROM. DataLen 
contains the amount of data to be written. If the function executes successfully then it will return OK 
otherwise it will return an error code. 



Visual Basic 
Parameter 

Handle 

Data 

DataLen 

C 

Parameter 

Handle 

Data 

DataLen 

Examples 



Type Description 

long A number that uniquely identifies the device 

string A buffer that holds the data from the User Area 

long A variable that holds the number of bytes to be read from the UA 

Type Description 

pvoid A pointer to a number that uniquely identifies the device 

puchar A pointer to a buffer that holds the data from the User Area 

dword A variable that holds the number of bytes to be read from the UA 



The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 
Dim strData As String * 64 
Dim IngDataLen As Long 

IngDataLen = 64 

IngStatus = FT_EE_UA Write (IngHandle, strData, IngDataLen) 
If IngStatus = OK Then 

'The function was successful, the UA on the EEPROM contains strData 



'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 
CHAR Data[64]; 
DWORD DataLen; 

DataLen = 64; 

Status = FT_ EE_ UA Write (Handle, &Data, DataLen); 
if (Status == OK) { 

// The function was successful, the UA on the EEPROM contains Data 

} 

{ 

// The function failed. The error code can be reviewed and appropriate corrective action taken 



} 
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FT_EE_Read (Handle, Data) 

This function will read the contents of the programmed section of the EEPROM and place the infor- 
mation into data structure Data. The type definition for Data is included in the header files at the end 
of this document. The function does not perform any checks on buffer sizes, so the buffers passed 
in the P ROG RAM_DATA structure must be big enough to accommodate their respective strings 
(including null terminators). The sizes shown in the following example are more than adequate and 
can be rounded down if necessary. The restriction is that the Manufacturer string length plus the 
Description string length is less than or equal to 40 characters. If the function executes successfully 
then it will return OK otherwise it will return an error code. 

Visual Basic 



Parameter Type Description 

Handle long A number that uniquely identifies the device 

Data structure A structure of type PROGRAM_DATA 

C 

Parameter Type Description 

Handle pvoid A pointer to a number that uniquely identifies the device 

Data structure A pointer to a structure of type PROGRAM_DATA 



Examples 

Using this function in Visual Basic becomes complicated because the PROGRAM_DATA structure 
contains only POINTERS to bytearrays. This means that the variables Manufacturer, 
Manufacturer! D, Description and SerialNumber are passed as POINTERS to the locations of bytear- 
rays. Each Byte in these arrays will be filled with one character of the whole string. Visual Basic sup- 
ports getting the addresses of pointers, however the functions to do so are undocumented. For more 
information on how to get pointers to variables in Visual Basic, see Microsoft Knowledge Base 
Article Q1 99824. The function used in this example is VarPtr, which returns the address of a vari- 
able. The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 
Dim EEData As PROGRAM_DATA 

'Bytearrays as "string-containers": 
Dim bManufacturer(32) As Byte 
Dim bManufacturerlD(W) As Byte 
Dim bDescription(64) As Byte 
Dim bSerialNumber(16) As Byte 

'Use an undocumented function to return a pointer 
EEData.Manufacturer = VarPtr (bManufacturer(O)) 
EEData.Manufacturerld = VarPtr (bManufacturerlD(O)) 
EEData.Description = VarPtr (bDescription(O)) 
EEData.SerialNumber = VarPtr (bSerialNumber(O)) 

IngStatus = FT_EE_Read (IngHandle, EEData) 
If IngStatus = OK Then 

'The function was successful, the information in the EEPROM is in EEData 

'Convert the resulting bytearrays to strings (NULL-characters at the end are cut off) 

strManufacturer = StrConv (bManufacturer, vbUnicode) 

strManufacturer = Left (strManufacturer, InStr (strManufacturer, Chr(0)) - 1) 
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strManufacturerlD = StrConv (bManufacturerlD, vbilnicode) 

strManufacturerlD = Left (strManufacturerlD, InStr (strManufacturerlD, Chr(O)) - 1) 

strDescription = StrConv (bDescription, vbilnicode) 

strDescription = Left (strDescription, InStr (strDescription, Chr(O)) - 1) 

strSerialNumber = StrConv (bSerialNumber, vbilnicode) 
strSerialNumber = Left (strSerialNumber, InStr (strSerialNumber, Chr(O)) - 1) 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 
PROGRAM_DATA EEData; 
char ManufacturerBuf[32]; 
char ManufacturerldBuf[ 16]; 
char DescriptionBuf[64]; 
char SerialNumberBuf[ 16]; 

EEData.Manufacturer = ManufacturerBuf; 
EEData.Manufacturerld = ManufacturerldBuf; 
EEData.Description = DescriptionBuf; 
EEData.SerialNumber = SerialNumberBuf; 

Status = FT_EE_Read (Handle, &EEData); 
if (Status == OK) { 

// The function was successful, the information in the EEPROM is in EEData 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 
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FT_EE_Program (Handle, Data) 

This function will write the contents of structure Data to the EEPROM. The type definition for Data is 
included in the header files at the end of this document. If the SerialNumber field in 
P ROG RAM_D ATA is NULL, or SerialNumber points to a NULL string, a serial number based on the 
Manufacturerld and the current date and time will be generated. If the function executes successfully 
then it will return OK otherwise it will return an error code. 

Visual Basic 



Parameter Type Description 

Handle long A number that uniquely identifies the device 

Data structure A structure of type PROGRAM_DATA 

C 

Parameter Type Description 

Handle pvoid A pointer to a number that uniquely identifies the device 

Data structure A pointer to a structure of type PROGRAM_DATA 



Examples 

Using this function in Visual Basic becomes complicated because the PROGRAM_DATA structure 
contains only POINTERS to bytearrays. This means that the variables Manufacturer, 
Manufacturer! D, Description and SerialNumber are passed as POINTERS to the locations of bytear- 
rays. Each Byte in these arrays will be filled with one character of the whole string. Visual Basic sup- 
ports getting the addresses of pointers, however the functions to do so are undocumented. For more 
information on how to get pointers to variables in Visual Basic, see Microsoft Knowledge Base 
Article Q1 99824. The function used in this example is VarPtr, which returns the address of a vari- 
able. The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 

Dim IngStatus As Long 

Dim EEData As PROGRAM_DATA 

Dim strManufacturer As String 

Dim strManufacturerlD As String 

Dim strDescription As String 

Dim strSerialNumber As String 

'Declare byte arrays as "string-containers": 
Dim bManufacturer(32) As Byte 
Dim bManufacturerlD(W) As Byte 
Dim bDescription(64) As Byte 
Dim bSerialNumber(W) As Byte 

'Load the strings 

strManufacturer = "Linx Technologies" 
strManufacturerlD = "LT" 
strDescription = "LINX SDM-USB-QS-S" 
strSerialNumber = "" 

'Load the EEData structure with the default data 
EEData. Vendorld = 0x0403 
EEData.Productld = 0xF448 
EEData.MaxPower = 100 
EEData. PnP = 1 
EEData.SelfPowered = 
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EEData.RemoteWakeup = 1 
EEData.Rev4 = TRUE 
EEData.lsoln = TRUE 
EEData.lsoOut = TRUE 
EEData.PullDownEnable = TRUE 
EEData.SerNumEnable = FALSE 
EEData.USBVersionEnable = FALSE 
EEData.USBVersion = 

'Use an undocumented function to return a pointer 
EEData.Manufacturer = VarPtr(bManufacturer(0)) 
EEData.Manufacturerld = VarPtr(bManufacturer!D(0)) 
EE Data. Description = VarPtr(bDescription(0)) 
EEData.SerialNumber = VarPtr(bSerialNumber(0)) 

'Convert the strings to byte arrays 
StringToByteArray (strManufacturer, bManufacturer) 
StringToByteArray (strManufacturerlD, bManufacturerlD) 
StringToByteArray (strDescription, bDescription) 
StringToByteArray (strSerialNumber, bSerialNumber) 

'Now write the complete set of EEPROM data 
IngStatus = FTJEEJProgram (IngHandle, EEData) 
If IngStatus = OK Then 

'The function was successful, the information in the EEPROM is in EEData 
Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 
End If 

'This function will convert a string to a byte array 

Private Sub StringToByteArray (strString, bByteArray) 

Dim IngN As Long 

Fill bByteArray with "0": 

For IngN = To UBound (bByteArray) 

bByteArray (IngN) = 
Next 

For IngN = 1 To Len(strString) 

bByteArray(lngN - 1) = Asc(Mid(strString, IngN, 1)) 
Next 
End Sub 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 
PROGRAM_DATA EEData; 

//Load the EEData structure with the default data 

EEData = {0x0403, 0xF449, "Linx Technologies", "LT", "LINX SDM-USB-QS-S", "", 44, 1, 0, 1, TRUE, TRUE, TRUE, 
TRUE, FALSE, FALSE, 0} 

Status = FT_EE_Program (Handle, &EEData); 
if (Status == OK) { 

// The function was successful, the information in EEData is in the EEPROM 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 
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FT_EraseEE (Handle) 

This function will erase the EEPROM. If the function executes successfully then it will return OK oth- 
erwise it will return an error code. 

Visual Basic 

Parameter Type Description 

Handle long A number that uniquely identifies the device 

C 

Parameter Type Description 

Handle pvoid A pointer to a number that uniquely identifies the device 

Examples 

The following Visual Basic code demonstrates this function. 

Dim IngHandle As Long 
Dim IngStatus As Long 

IngStatus = FT_EraseEE (IngHandle) 
If IngStatus = OK Then 

'The function was successful, the EEPROM has been erased 

Else 

'The function failed. The error code can be reviewed and appropriate corrective action taken 

End If 

The following C code demonstrates this function. 

PVOID Handle; 
ULONG Status; 

Status = FT_EraseEE (Handle); 
if (Status == OK) { 

// The function was successful, the EEPROM has been erased 

} 

else { 

// The function failed. The error code can be reviewed and appropriate corrective action taken 

} 
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A ppendix A 

QS Series Visual Basic Header File 

This appendix contains the Visual Basic header file that contains all of the function and constant def- 
initions covered in this guide. This text can be copied and pasted into a module in the user's Visual 
Basic project. 

' Function declarations 

Public Declare Function FT_ListDevices Lib "FTD2XX.DLL" (ByVal arg1 As Long, ByVal arg2 As String, ByVal dwFlags As Long) As Long 
Public Declare Function FT_Open Lib "FTD2XX.DLL " (ByVal intDeviceNumber As Integer, ByRef IngHandle As Long) As Long 
Public Declare Function FT_OpenEx Lib "FTD2XX.DLL" (ByVal arg1 As String, ByVal arg2 As Long, ByRef IngHandle As Long) As Long 
Public Declare Function FT_Close Lib "FTD2XX.DLL" (ByVal IngHandle As Long) As Long 

Public Declare Function FT_Read Lib "FTD2XX.DLL" (ByVal IngHandle As Long, ByVal IpszBuffer As String, ByVal IngBufferSize As Long,_ 

ByRef IngBytesReturned As Long) As Long 
Public Declare Function FT_Write Lib "FTD2XX.DLL" (ByVal IngHandle As Long, ByVal IpszBuffer As String, ByVal IngBufferSize As Long,_ 

ByRef IngBytesWritten As Long) As Long 
Public Declare Function FT_SetBaudRate Lib "FTD2XX.DLL" (ByVal IngHandle As Long, ByVal IngBaudRate As Long) As Long 
Public Declare Function FT_SetDataCharacteristics Lib "FTD2XX.DLL" (ByVal IngHandle As Long, ByVal byWordLength As Byte,_ 

ByVal byStopBits As Byte, ByVal byParity As Byte) As Long 
Public Declare Function FT_SetFlowControl Lib "FTD2XX. DLL " (ByVal IngHandle As Long, ByVal intFlowControl As Integer, ByVal byXonChar As Byte,_ 

ByVal byXoffCharAs Byte) As Long 
Public Declare Function FT_SetDtr Lib "FTD2XX.DLL" (ByVal IngHandle As Long) As Long 
Public Declare Function FT_ClrDtr Lib "FTD2XX.DLL" (ByVal IngHandle As Long) As Long 
Public Declare Function FT_SetRts Lib "FTD2XX.DLL" (ByVal IngHandle As Long) As Long 
Public Declare Function FT_ClrRts Lib "FTD2XX.DLL" (ByVal IngHandle As Long) As Long 

Public Declare Function FT_GetModemStatus Lib "FTD2XX.DLL" (ByVal IngHandle As Long, ByRef IngModemStatus As Long) As Long 

Public Declare Function FT_SetChars Lib "FTD2XX.DLL" (ByVal IngHandle As Long, ByVal byEventChar As Byte, ByVal byEventCharEnabled As Byte,_ 

ByVal byErrorChar As Byte, ByVal byErrorCharEnabled As Byte) As Long 
Public Declare Function FT_Purge Lib "FTD2XX.DLL" (ByVal IngHandle As Long, ByVal IngMask As Long) As Long 
Public Declare Function FT_SetTimeouts Lib "FTD2XX.DLL" (ByVal IngHandle As Long, ByVal IngReadTimeout As Long,_ 

ByVal IngWriteTimeout As Long) As Long 
Public Declare Function FT_GetQueueStatus Lib "FTD2XX.DLL" (ByVal IngHandle As Long, ByRef IngRXBytes As Long) As Long 
Public Declare Function FT_SetBreakOn Lib "FTD2XX.DLL" (ByVal IngHandle As Long) As Long 
Public Declare Function FT_SetBreakOff Lib "FTD2XX.DLL" (ByVal IngHandle As Long) As Long 

Public Declare Function FT_GetStatus Lib "FTD2XX.DLL" (ByVal IngHandle As Long, ByRef IngRXBytes As Long, ByRef IngTXBytes As Long,_ 

ByRef IngEventsDWord As Long) As Long 
Public Declare Function FT_ResetDevice Lib "FTD2XX.DLL" (ByVal IngHandle As Long) As Long 

' New Functions 

Public Declare Function FT_SetEventNotification Lib "FTD2XX.DLL' (ByVal IngHandle As Long, ByVal dwEventMask As Long, ByVal Arg As Long)_ 
As Long 

Public Declare Function FT_ResetPort Lib "FTD2XX.DLL" (ByVal IngHandle As Long) As Long 
Public Declare Function FT_RestartlnTask Lib "FTD2XX.DLL" (ByVal IngHandle As Long) As Long 
Public Declare Function FT_StoplnTask Lib "FTD2XX.DLL" (ByVal IngHandle As Long) As Long 

Public Declare Function FT_SetResetPipeRetryCount Lib "FTD2XX.DLL" (ByVal IngHandle As Long, ByVal IngCountAs Long) As Long 



' EEPROM programming function declarations 



Public Declare Function FT_EEJProgram Lib "FTD2XX.DLL" (ByVal IngHandle As Long, ByRef IpData As PROGRAM_DATA) As Long 

Public Declare Function FT_EE_Read Lib "FTD2XX.DLL" (ByVal IngHandle As Long, ByRef IpData As PROGRAM_DATA) As Long 

Public Declare Function FTJEEJJARead Lib "FTD2XX.DLL" (ByVal IngHandle As Long, ByVal pucData As String, ByVal dwDataLen As Long,_ 

ByRef IpdwBytesRead As Long) As Long 
Public Declare Function FT_EE_UA Write Lib "FTD2XX.DLL " (ByVal IngHandle As Long, ByVal pucData As String, ByVal dwDataLen As Long) As Long 
Public Declare Function FT_EE_UASize Lib "FTD2XX.DLL" (ByVal IngHandle As Long, ByRef IpdwSize As Long) As Long 
Public Declare Function FT_EraseEE Lib "FTD2XX.DLL" (ByVal IngHandle As Long) As Long 

' Supporting functions for conversion from C to Visual Basic 
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' Used instead of FT_ListDevices to get the number of devices on the bus 

Public Declare Function FT_GetNumDevices Lib "FTD2XX.DLL" Alias "FT_ListDevices" (ByRef arg1 As Long, ByVal arg2 As String,_ 
ByVal dwFlags As Long) As Long 



' Constant Declarations 

' Return codes 

Public Const OK=0 

Public Const INVALID_HANDLE = 1 

Public Const DEVICE_NOT_FOUND = 2 

Public Const DEVICE_NOT_OPENED = 3 

Public Const IO_ERROR = 4 

Public Const INSUFFICIENT_RESOURCES = 5 

Public Const INVALID_PARAMETER = 6 

Public Const INVALID_BAUD_RATE = 7 

Public Const DEVICE_NOT_OPENED_FOR_ERASE = 8 
Public Const DEVICE_NOT_OPENED_FOR_ WRITE = 9 
Public Const FAILED_TO_WRITE_DEVICE = 10 
Public Const EEPROM_READ_FAILED = 1 1 
Public Const EEPROM_ WRITE_FAILED = 12 
Public Const EEPROM_ERASE_F AILED = 13 
Public Const EEPROM_NOT_PRESENT = 14 
Public Const EEPROM_NOT_PROGRAMMED = 15 
Public Const INVALID_ARGS = 16 
Public Const OTHER_ERROR = 17 

' Flow Control 

Public Const FLOW_NONE = &H0 
Public Const FLOW_RTS_CTS = &H100 
Public Const FLOW_DTR_DSR = &H200 
Public Const FLOW_XON_XOFF = &H400 

' Purge rx and tx buffers 
Public Const PURGE_RX = 1 
Public Const PURGE_TX = 2 

' Flags for FT_OpenEx 

Public Const OPEN_BY_SERIAL_NUMBER = 1 
Public Const OPEN_BY_DESCRlPT!ON « 2 

' Flags for FT_ListDevices 

Public Const LIST_BY_NUMBER_ONLY = &H80000000 
Public Const LIST_BY_INDEX = &H40000000 
Public Const LIST_ALL - &H20000000 

ivivuurn oiaius 
Public Const MODEM_STATUS_CTS = &H10 
Public Const MODEM_STA TUS_DSR = &H20 
Public Const MODEM_STATUS_RI = &H40 
Public Const MODEM_STA TUS_DCD = &H80 

event Masks 

Public Const EVENT_RXCHAR = 1 

Public Const EVENT_MODEM_STATUS = 2 

' Baud Rates 

Public Const BAUD_300 = 300 
Public Const BAUD_600 = 600 
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Public Const BAUD_ 1200 = 1200 
Public Const BAUD_2400 = 2400 
Public Const BAUD_4800 = 4800 
Public Const BAUD_9600 = 9600 
Public Const BAUD_ 14400 = 14400 
Public Const BAUD_ 19200 = 19200 
Public Const BAUD_38400 = 38400 
Public Const BAUD_57600 = 57600 
Public Const BAUD_ 1 15200 = 1 15200 
Public Const BAUD_230400 = 230400 
Public Const BAUD_460800 = 460800 
Public Const BAUD_921600 = 921600 



' Word Lengths 
Public Const BITS_8 = 8 
Public Const BITS_7 = 7 
Public Const BITS_6 = 6 
Public Const BITS_5 = 5 



' Stop Bits 

Public Const STOP_BITS_1 = 
Public Const STOP_BITS_ 1_5 * 1 
Public Const STOP_BITS_2 = 2 

' Parity 

Public Const PARITY_NONE = 
Public Const PARITY_ODD = 1 
Public Const PARITY_EVEN = 2 
Public Const PARITY_MARK = 3 
Public Const PARITY_SPACE = 4 



' Type declaration for EEPROM programming 
Public Type PROGRAM_DATA 

Vendorld As Integer 

Productld As Integer 

Manufacturer As Long 

Manufacturer^ As Long 

Description As Long 

SerialNumber As Long 

MaxPower As Integer 

PNP As Integer 

SelfPowered As Integer 

RemoteWakeup As Integer 

' Rev4 extensions: 

Rev4 As Byte 

Isoln As Byte 

IsoOut As Byte 

PullDownEnable As Byte 

SerNumEnable As Byte 

USBVersionEnable As Byte 

USBVersion As Integer 
End Type 



■0x0403 
VxF448 

'32 "Linx Technologies" 
■16 "LT" 

■64 "LINX SDM-USB-QS-S" 
■16 "LT000001" if fixed, or NULL 
'0 < MaxPower <= 500 
'0 = disabled, 1 = enabled 
'0 = bus powered, 1 = self powered 
'0 = not capable, 1 = capable 

'true if Rev4 chip, false otherwise 
'true if in endpoint is isochronous 
'true if out endpoint is isochronous 
'true if pull down enabled 
'true if serial number to be used 
'true if chip uses USBVersion 
■BCD (0x0200 => USB2) 
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A ppendix B 

QS Series C Header File 

This appendix contains the C header file that contains all of the function and constant definitions cov- 
ered in this guide. This text can be copied and pasted into a module in the user's C project. 

#ifndef FTD2XX_H 
#define FTD2XX_H 

// The following ifdef block is the standard way of creating macros 

// which make exporting from a DLL simpler. All files within this DLL 

//are compiled with the FTD2XX_EXPORTS symbol defined on the command line. 

// This symbol should not be defined on any project that uses this DLL. 

// This way any other project whose source files include this file see 

// FTD2XX_API functions as being imported from a DLL, whereas this DLL 

//sees symbols defined with this macro as being exported. 

mfdef FTD2XX_EXPORTS 

#define FTD2XX_API declspec(dllexport) 

ftelse 

ft define FTD2XX_API declspec(dllimport) 

ftendit 

typedefPVOID HANDLE; 
typedefULONG STATUS; 

//Function declarations 

FTD2XX_API STATUS WINAPI FT_ListDevices (PVOID pArgt, PVOID P Arg2, DWORD Flags); 
FTD2XX_API STATUS WINAPI FTjOpen (int deviceNumber, HANDLE 'pHandle); 
FTD2XX_API STATUS WINAPI FT_OpenEx (PVOID pArgl, DWORD Flags, HANDLE 'pHandle); 
FTD2XX_API STATUS WINAPI FT_Close (HANDLE Handle); 

FTD2XX_API STATUS WINAPI FT_Read (HANDLE Handle, LPVOID IpBuffer, DWORD nBufferSize, LPDWORD IpBytesReturned); 
FTD2XX_API STATUS WINAPI FT_Write (HANDLE Handle, LPVOID IpBuffer, DWORD nBufferSize, LPDWORD IpBytes Written); 
FTD2XX_API STATUS WINAPI FT_SetBaudRate (HANDLE Handle, ULONG BaudRate); 

FTD2XX_API STATUS WINAPI FT_SetDataCharacteristics (HANDLE Handle, UCHAR WordLength, UCHAR StopBits, UCHAR Parity); 
FTD2XX_API STATUS WINAPI FT_SetFlowControl (HANDLE Handle, USHORT FlowControl, UCHAR XonChar, UCHAR XoffChar); 
FTD2XX_API STATUS WINAPI FT_SetDtr (HANDLE Handle); 
FTD2XX_API STATUS WINAPI FT_ClrDtr (HANDLE Handle); 
FTD2XX_API STATUS WINAPI FT_SetRts (HANDLE Handle); 
FTD2XX_API STATUS WINAPI FT_ClrRts (HANDLE Handle); 

FTD2XX_API STATUS WINAPI FT_GetModemStatus (HANDLE Handle, ULONG 'pModemStatus); 

FTD2XX_API STATUS WINAPI FT_SetChars (HANDLE Handle, UCHAR EventChar, UCHAR EventCharEnabled, UCHAR ErrorChar, UCHAR 

ErrorCharEnabled); 
FTD2XX_API STATUS WINAPI FT_Purge (HANDLE Handle, ULONG Mask); 

FTD2XX_API STATUS WINAPI FT_SetTimeouts (HANDLE Handle, ULONG ReadTimeout, ULONG WriteTimeout); 
FTD2XX_API STATUS WINAPI FT_GetOueueStatus (HANDLE Handle, DWORD 'dwRxBytes); 
FTD2XX_API STATUS WINAPI FT_SetBreakOn (HANDLE Handle); 
FTD2XX_API STATUS WINAPI FT_SetBreakOff (HANDLE Handle); 

FTD2XX_API STATUS WINAPI FT_GetStatus (HANDLE Handle, DWORD 'dwRxBytes, DWORD 'dwTxBytes, DWORD 'dwEventDWord); 
FTD2XX_API STATUS WINAPI FT_ResetDevice (HANDLE Handle); 

FTD2XX_API STATUS WINAPI FT_SetEventNotification (HANDLE Handle, DWORD Mask, PVOID Param); 
FTD2XX_API STATUS WINAPI FT_ResetPort (HANDLE Handle); 
FTD2XX_API STATUS WINAPI FT_RestartlnTask (HANDLE Handle); 
FTD2XX_API STATUS WINAPI FT_StoplnTask (HANDLE Handle); 

FTD2XX_API STATUS WINAPI FT_SetResetPipeRetryCount (HANDLE Handle, DWORD dwCount); 



//......„.,.....,....,..„. „, 

//EEPROM function declarations 
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FTD2XX_API STATUS WINAPI FTJEEJProgram (HANDLE Handle, PPROGRAM_DATA pData); 
FTD2XX_API STATUS WINAPI FT_EE_Read (HANDLE Handle, PPROGRAM_DATA pData); 

FTD2XX_API STATUS WINAPI FT_EE_ UARead (HANDLE Handle, PUCHAR pucData, DWORD dwDataLen, LPDWORD IpdwBytesRead); 
FTD2XX_API STATUS WINAPI FT_EE_UAWrite (HANDLE Handle, PUCHAR pucData, DWORD dwDataLen); 
FTD2XX_API STATUS WINAPI FT_EE_UASize (HANDLE Handle, LPDWORD IpdwSize); 
FTD2XX_API STATUS WINAPI FT_EraseEE (HANDLE Handle); 



JJ* **************** : 

//Constant Declarations 

yy************************** 

'//Return codes 
enum { 
OK, 

INVALID_HANDLE, 
DEVICE_NOT_FOUND, 
DEVICE_NOT_OPENED, 
IO_ERROR, 

INSUFFICIENT_RESOURCES, 

INVALID_PARAMETER, 

INVALID_BAUD_RATE, 



DEVICE_NOT_OPENED_FOR_ERASE, 

DEVICE_NOT_OPENED_FOR_WRITE, 

FAILED_ TO_ WRITE_DEVICE, 

EEPROM_READ_FAILED, 

EEPROM_WRITE_FAILED, 

EEPROM_ERASE_F AILED, 

EEPROM_NOT_PRESENT, 

EEPROM_NOT_PROGRAMMED, 

INVALID_ARGS, 

OTHER_ERROR 



// Flow Control 
ttdefine FLOW_NONE 
ttdefine FLOW_RTS_CTS 
ttdefine FLOW_DTR_DSR 
#define FLOW_XON_XOFF 

// Purge rx and tx buffers 
ttdefine PURGE_RX 
ttdefine PURGEJTX 



0x0000 
0x0100 
0x0200 

0x0400 



1 

2 



1 
2 



// FT_OpenEx Flags 

Mdefine OPEN_BY_SERIAL_NUMBER 

#define OPEN_BY_DESCRIPTION 



// FT_ListDevices Flags (used in conjunction with FT_OpenEx Flags) 

trdefine LIST_NUMBER_ONLY 0x80000000 

#define LIST_BY_INDEX 0x40000000 

Xdefine LIST_ALL 0x20000000 

Vdefine LIST_MASK (LIST_NUMBER_ONLY I LIST_BYJNDEX I LIST_ALL) 



//Modem Status 

trdefine MODEMJSTATUSJCTS &H10 

trdefine MODEM_STATUS_DSR &H20 

ttdefine MODEM_STATUS_RI &H40 

ttdefine MODEM_STATUS_DCD &H80 



// Event Masks 
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#define EVENT_RXCHAR 


1 


tfdefine EVENT_MODEM_STATUS 


2 


// Baud Rates 




#define BAUD_300 


300 


#define BAUD_600 


600 


#define BAUD_ 1200 


1200 


#define BAUD_2400 


2400 


#define BAUD_4800 


4800 


#define BAUD_9600 


9600 


#define BAUD_14400 


14400 


tfdefine BAUD_1 9200 


19200 


if define BAUD_38400 


38400 


ff define BAUD_57600 


57600 


tfdefine BAUD_ 1 15200 


1 15200 


tfdefine BAUD_230400 


230400 


tfdefine BAUD_460800 


460800 


tfdefine BAUD_921600 


921600 


// Word Lengths 




tfdefine BITS_8 


(UCHAR) 8 


tfdefine BITS_7 


(UCHAR) 7 


tfdefine BITS_6 


(UCHAR) 6 


tfdefine e/7S_5 


(UCHAR) 5 


//Stop Bits 




tfdefine STOP_BITS_1 


(UCHAR) 


tfdefine STOP_BITS_1_5 


(UCHAR) 1 


tfdefine STOP_BITS_2 


(UCHAR) 2 


//Parity 




tfdefine PARITY_NONE 


(UCHAR) 


tfdefine PARITY_ODD 


(UCHAR) 1 


tfdefine PARITY_EVEN 


(UCHAR) 2 


tfdefine PARITY_MARK 


(UCHAR) 3 


tfdefine PARITY_SPACE 


(UCHAR) 4 



// Type declaration for EEPROM programming 
typedef struct PROGRAM_DATA { 

WORD Vendorld; 

WORD Productld; 

char 'Manufacturer; 

char 'Manufacturer^; 

char "Description; 

char 'SerialNumber; 

WORD MaxPower; 

WORD PnP; 

WORD SelfPowered; 

WORD RemoteWakeup; 

// Rev4 extensions 

UCHAR Rev4; 

UCHAR Isoln; 

UCHAR IsoOut; 

UCHAR PullDownEnable; 

UCHAR SerNumEnable; 

UCHAR USBVersionEnable; 

WORD USB Version; 
} PROGRAM_DA TA, "PPROGRAM_DATA; 



// 0x0403 
//0xF448 

// 32, "Linx Technologies" 
// 16, "LT" 

//64 "LINX SDM-USB-QS-S" 
// 16 "LT000001" if fixed, or NULL 
// < MaxPower <= 500 
//0 = disabled, 1 = enabled 
//0 = bus powered, 1 = self powered 
// = not capable, 1 ■■ 



// true if Rev4 chip, false otherwise 
// true if in endpoint is isochronous 
// true if out endpoint is isochronous 
// true if pull down enabled 
// true if serial number to be used 
// true if chip uses USBVersion 
//BCD (0x0200 => USB2) 
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All text and code contained within this document is copyrighted by Linx Technologies, Inc. Permission 
to use the code is only granted if used in conjunction with the Linx SDM-USB-QS-S Module. This code 
is provided as an example to aid our customers in their development and may or may not be appro- 
priate for an individual application. 

This code is provided "As Is" and Linx Technologies makes no guarantee, warranty, or representation 
regarding the suitability of any product or code for use in a specific application. 



